=== Better Bot Hunter 3 ===
Contributors: oliverkler
Tags: bot, spam, security, blacklist, honeypot
Requires at least: 6.5
Tested up to: 6.7
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Protects your WordPress site from malicious bots using a hidden honeypot, dynamic IP filtering, and brute-force protection.

== Description ==

Better Bot Hunter 3 is a powerful security plugin that protects your WordPress site from malicious bots through dynamic IP filtering, honeypot detection, and brute-force protection. It quickly blocks excessive login attempts, protects against brute-force attacks, and significantly reduces SPAM. An intuitive admin UI makes managing the blacklist and whitelist effortless.

= Features =

* Hidden honeypot link in the footer — bots automatically fall into the trap
* Automatic IP detection and blocking via blacklist
* Server-side blocking via .htaccess (Apache 2.2 & 2.4, IPv4 & IPv6) — works even with page caching
* Whitelist with priority over the blacklist
* Automatic whitelisting of the login IP on every login
* Admin UI with tabs for Blacklist, Whitelist, Settings, and Log
* Import and export of Blacklist and Whitelist as CSV
* Email notifications for new blacklist entries
* Dashboard widget with real-time statistics
* Full activation and uninstall handling
* Supports German and English

== Installation ==

1. Upload the plugin folder `bot-hunter` to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Configure the settings under 'Settings -> Better Bot Hunter 3'.

== Frequently Asked Questions ==

= How does the honeypot work? =
An invisible link is inserted in the footer of every page. Real visitors never see or click it. Bots that automatically follow all links on a page trigger it and are immediately added to the blacklist.

= Does the plugin work with page caching? =
Yes. Blocked IPs are also written to .htaccess and blocked at the Apache level — before WordPress or the cache is loaded.

= Will my own IP be blocked? =
No. When you log in, your current IP is automatically added to the whitelist, protecting it from accidental blocking.

= Can I manage IPs manually? =
Yes. Under 'Settings -> Better Bot Hunter 3' you can manually add, remove, and transfer IPs between the blacklist and whitelist. CSV import and export is also available.

= Which IP versions are supported? =
Both IPv4 and IPv6 are fully supported — including server-side blocking via .htaccess.

== Screenshots ==

1. Dashboard widget with blacklist and whitelist statistics
2. Admin UI — Blacklist tab
3. Admin UI — Whitelist tab
4. Admin UI — Settings tab
5. Admin UI — Log tab

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release.

== External Services ==

= AbuseIPDB =
When the AbuseIPDB integration is enabled, the plugin sends the IP address of detected bots to the AbuseIPDB API to retrieve the abuse confidence score. If reporting mode is active, the IP address is also reported to AbuseIPDB.

* Service: https://www.abuseipdb.com/
* API endpoint: https://api.abuseipdb.com/api/v2/
* Privacy policy: https://www.abuseipdb.com/privacy-policy
* Terms of service: https://www.abuseipdb.com/terms

Data transmitted: The IP address of the detected bot. Only sent when AbuseIPDB integration is explicitly enabled by the site administrator.

= Donor Verification =
When the site administrator manually clicks the "Verify" button in the plugin settings, the entered email address and the site URL are transmitted to updates.bothunterplugin.de to verify donor status. No data is transmitted automatically or without explicit user action.

* Service: https://updates.bothunterplugin.de/
* Privacy policy: https://www.bothunterplugin.de/datenschutz
